home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / utilities / _printapps / printapps / _dualprint / _help < prev    next >
Encoding:
Text File  |  1990-06-17  |  4.9 KB  |  132 lines
  1.  !Help for DualPrint Version 1.22
  2.  ----------------------------------
  3.  
  4. Files included in this package :-
  5.  
  6. !Run
  7. !RunImage
  8. !Sprites
  9. !Help
  10. DualComs
  11. Templates
  12.  
  13.  Purpose
  14. ---------
  15.  
  16. DualPrint facilitates the printing of 2 column BASIC listings.
  17.  
  18. 10 *****                 10 *****  30 ***
  19. 20 ****                  20 ****   40 **
  20. 30 ***    > DualPrint >            50 *
  21. 40 **
  22. 50 *
  23.  
  24.  Usage
  25. -------
  26.  
  27. Use *SPOOL or BEEBUG's "B_to_T" to generate a text file listing of the BASIC
  28. program you want displayed, then drag the file onto the DualPrint icon. Menu
  29. on the icon permits you to change the print pitch so that long lines are
  30. less likely to be split up. The selection is recorded by the tick to the
  31. left of the item. If your printer is not listed manually configure it to the
  32. desired print pitch, then use the Any printer option to tell DualPrint the
  33. number of characters on each line. To abort printing press <ESCAPE>.
  34.  
  35.  Notes
  36. -------
  37.  
  38. Even when printing DualPrint is a multi-tasking application. Multiple
  39. installations of DualPrint are impossible. When a file is dragged onto the
  40. DualPrint icon it is copied onto the ram disc as "PrintFile". This file can
  41. itself be dragged onto DualPrint if you require a second copy. If the file
  42. is too large for the ram disc an error message will be issued giving the
  43. amount of memory to assign to the ram disc. Only DATA files and TEXT files
  44. are received. Any files which contain less than 2 lines of BASIC are
  45. ignored. It is impossible to load up a second file whilst DualPrint is
  46. processing the first. Lines from the file will be displayed only if they are
  47. terminated by a character of ASCII value 13 or less and the first non-space
  48. character is a numeral. If P is the print width (10 - 255 characters) the
  49. layout of a line is as follows :-
  50.  
  51. {(P DIV 2 - 1) chars}"  "{(P DIV 2 - 1) chars}
  52.  
  53. A listing is split so that there is always a new line of BASIC heading the
  54. second column. Lines are sent to the printer once every null "Wimp_Poll"
  55. with *FX 3,10.
  56.  
  57.  DualComs 1.03
  58. ---------------
  59.  
  60. This module provides 2 *Commands used by DualPrint.
  61.  
  62. CheckEsc is the means by which DualPrint responds to the user pressing
  63. <ESCAPE>. If the command is prefixed by a 1 the keyboard event is enabled
  64. and an event handler installed; a 0 parameter removes the handler and
  65. releases the event. Attempts to install or remove the handler twice in
  66. succession will be ignored. After a CheckEsc command without a parameter the
  67. escape state will be passed in the user flag. If the user flag is set to 27
  68. the <ESCAPE> key has been pressed since the last check.
  69.  
  70. Syntax : *CheckEsc [<0 1>]
  71.  
  72. RamFS reserves an area of memory for the RAM Filing system. The size can be
  73. either bytes or Kilobytes, but the value will be rounded up to the nearest
  74. page boundary. If the ram disc is already larger than the new setting or if
  75. it contains files then it will not be altered.
  76.  
  77. Syntax : *RamFS <size>[K]
  78.  
  79.  Versions
  80. ----------
  81.  
  82. 1.00  Fully functional.
  83.  
  84. 1.10  Menu expanded to cope with any printer, but the user must initialise
  85.       the printer as required. Responds to !Help. Fix for an obscure bug.
  86.       Appended ">"  to listing. Traps Filing system or path 'RAM:' not
  87.       present error. Checks to see whether the printer is connected. When
  88.       printing is in progress, the printer options are shaded and pressing
  89.       <ESCAPE> halts the preceedings.
  90.  
  91. 1.11  Major flaw in the print layout corrected.
  92.  
  93. 1.20  Listings enhanced by the identation of broken lines. Pause between
  94.       pages implemented. PrintFile window contains name, number of lines,
  95.       printer, print width, pause option, indent option and page length. The
  96.       printer characteristics can be changed whilst the window is on screen.
  97.       Polished the printer sensing. Debugged DualComs.
  98.  
  99.       ... Hopefully the last version ...
  100.  
  101. 1.21  Prevented the options icons from becoming out of sync with the setting
  102.       as a result of dragging. Improved the loading procedure. Definitive
  103.       DualComs. Fixed 2 bugs in the file analysis routine.
  104.  
  105. 1.22  Optimised the templates and made a few aesthetic changes to the
  106.       program.
  107.  
  108.  Conditions of Use
  109. -------------------
  110.  
  111. This application is supplied free for general use "as is", I cannot
  112. guarantee that it is free from bugs or give any warranty about its
  113. suitability for use. You have my permission to give this program to anyone
  114. you please via any medium, provided it is delivered with ALL original files.
  115. Please notify me immediately if you have any problems and I will see what
  116. can be done. I expressly forbid anybody to supply this program on a disc
  117. which is being charged for. If you bought this program contact me
  118. immediately. If you want to borrow some of my code for another shareware
  119. project then please remember to credit me! If you want to use my work for
  120. sale then my acceptance must be sought in writing. I maintain copyright on
  121. all the material supplied and reserve the right to ammend these conditions
  122. in cases where I deem misuse.
  123.  
  124.  Contacts
  125. ----------
  126.  
  127. 63 Cromwell Rd
  128. Canterbury
  129. KENT
  130. CT1 3LE
  131.  
  132. © Mark.J.Collier 1990